+What is Script-O-Matic?

 It's a program that generates Quake 3 Arena scripts out of data given by user.
 User selects maps and bots, sets up options and presses "Create & Run Q3A" 
 button. First the program builds a script and writes it to the baseq3 <DIR>. 
 If a script with the same name already exists, user is promted. There are three 
 choises: YES, NO and ABORT. YES overwrites the previous script and runs the 
 game. NO runs the game using previously made script. ABORT does none of the 
 above. NO is usefull when you play a Team Deathmatch game and want to switch 
 to a Team Mod game. Be carefull not to play CTF game on regular maps!

+What's new in the latest version:
 User can select which map is the circle began with. Map on the active tab is going 
 to be first. Also program remembers that on exit.

+When is new creation of the script mandatory?

 -if you changed a type of game (except Team -> Team Mod & vice versa)
 -if you changed the Bot Skill
 -of course when you changed maps and bots

+Creation and game run:

 I know some of you will wonder why couldn't you just create a script with this program 
 and run it with "+exec yourscript.cfg" passed to shortcut on your desktop. Well, you 
 can do that, but all the options set in Script-O-Matic will be ignored. First version of 
 Script-O-Matic wrote everything in a CFG file, but script wouldn't work as it supposed 
 to. Q3 console wouldn't hear about my timelimit, capturelimit and so on. So I deceded 
 to pass this settings (all on Options tab except Bot skill) directly to quake3.exe and it 
 worked! No more hard restarts after warmup timeout and other unpleasant side effects.

+Add additional maps and bots!

 Comboboxes with maps and lists containing bots are dynamicly filled, meaning that 
 everytime a program is run, data is read out of "q3script.ini" file. Rules for adding are 
 on the top of INI file. If you leave something out (e.g. bool value), Script-O-Matic will 
 remind you. The other thing you should know is that with every new bot and map, 
 graphic file is expected. The only supported file extension is JPG!

*Adding a map (let's say fr3dm1) example:
 In section [Maps] of q3script.ini file add a line:
 fr3dm1="Iron Yard",1,0,1
 Now you must know that fr3dm1.jpg is expected in \Maps <DIR>. If you want it to look 
 nice, you should resize it to 199x199 using bilinear or (even better) bicubic filter.

*Addind a bot (let's say Pi) example:
 In section [Bots] of q3script.ini file add a line:
 Pi=1,"pi_default"
 Now you must know that "pi_default.jpg" is expected in \Players <DIR>. If you want it to 
 look nice, you should resize it to 57x57 using bilinear or (even better) bicubic filter.
 When we said 1 in description, we ment that this bot has a AI and is not just a skin. So 
 with this bot is "pi_red.jpg" and "pi_blue.jpg" also expected in \Players <DIR>.
 Other bots (e.g. Yuriko=0,"slash_yuriko") don't need red and blue JPG file.

+Known issues:

 FFA and Tournament don't work. First map runs OK, but in the second map all the bots 
 are turned into ghosts. I can't fix that with my current scripting knowledge. All I know 
 is that ghost problem in team games is caused by "g_teamAutoJoin 1". So I specificly 
 pass everytime "g_teamAutoJoin 0" to quake3.exe. Well since this utility was intended 
 for creation of team games, that doesn't boter me a lot, but if you think you got a 
 solution for that, please email me.
 Another thing is that choosing model for single player game works and for team game not. 
 I'm using the same command in both cases (\model & \headmodel) and don't know what 
 else is there to do.

+Nice tip!

 Are on your computer playing more than one player, some with inverted mouse and some 
 without? Here's a line you should add in a "q3config.cfg" to simply change between the two 
 mouse modes using M key:

 seta invert_mouse_on "m_pitch -0.022000; wait; bind M vstr invert_mouse_off"
 seta invert_mouse_off "m_pitch 0.022000; wait; bind M vstr invert_mouse_on"

Author Primoz Sternad
email: primoz.sternad@email.si
